Inside Macintosh: Open Transport /

Chapter 6 - Configuration Management / Configuration Management Reference

Functions / Getting Information About Ports

OTGetSlotFromPortRef

Extracts slot information from a port reference.

C INTERFACE

UInt16 OTGetSlotFromPortRef (OTPortRef ref, 
                             UInt16* other);

C++ INTERFACES

None. C++ applications use the C interface to this function.

PARAMETERS

ref

The port reference from which you wish to extract the
slot number.

other

A pointer to a 16-bit buffer you provide into which the function places a value that distinguishes between ports when more than one hardware port is connected to a given slot. Specify NULL for this parameter if you do not want the function to return this information.

DESCRIPTION

The OTGetSlotFromPortRef function extracts slot information from a port reference with unknown hardware values. You can obtain such a port reference when another application passes one to you or when you use the OTGetIndexedPort function to access a port structure into which another application has put its own port reference.

Note that the slot numbers are physical; that is, they are the slot numbers returned by the Slot Manager and not the slots seen in various network configuration applications. Physical slot numbers depend on the type of card installed. For example, NuBus cards number their slots 9-13, which appear in the AppleTalk or TCP control panels as slots 1-5.

SEE ALSO

For information about finding ports and obtaining a port reference, see the sections "About Port Information" (page 6-5) and "Obtaining Port Information" (page 6-11).

You can use the OTGetDeviceTypeFromPortRef function (page 6-38) and the OTGetBusTypeFromPortRef function (page 6-39) to get device type and bus type information from the port reference.

You can use the OTCreatePortRef function (page 6-35) to create a port reference.

Port references are returned by the OTGetIndexedPort function (page 6-32), the OTFindPort function (page 6-33), and the OTFindPortByRef function (page 6-34).

The port structure is described in "The Port Structure" (page 6-17) and the port reference is described in "The Port Reference" (page 6-19).